home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 020a / anifra.zip / ANIFRA.DOC < prev    next >
Text File  |  1991-10-09  |  7KB  |  180 lines
  1. Documentation file for ANIFRA ver. 1.0.
  2.  
  3. The archive shold contain the following files and should allways be 
  4. distributed as a complete package:
  5.  
  6.        ANIFRA.C      source for ANIFRA
  7.        ANIFRA.EXE    executable
  8.        ANIFRA.DOC    this file.
  9.  
  10. ANIFRA is a small utility for generating bat and parameter files for
  11. fractal animations. This program only creates input to FRACTINT, 
  12. it does not generate fractals itself. FRACTINT is a powerfull 
  13. freeware fractal explorer written by the Stone Soup Group.  
  14.  
  15. ANIFRA Version 1.0 supports ZOOM, circular moves, liniear moves and 
  16. point. So far only center and/or parameter movement is supported, more 
  17. options is to appear in a future version. 
  18.  
  19. This program is not copyrighted and is placed into the public domain.  
  20. Feel free to use whatever pieces of code you want. If you modify this 
  21. code or add new options I would appriciate a copy so I can review the 
  22. changes for inclusion in a future version. This is only my 3rd C program 
  23. so don't expect anything fancy. 
  24.  
  25. I can be reached on CI$ as 100016,1620 
  26. or on YCCMR as Erkki Soendergaard. 
  27.  
  28. My mail address is:
  29.  
  30.      Erkki Soendergaard
  31.      Aarhusgade 44, 1 tv.
  32.      DK-2100 Copenhagen Oe.
  33.      Denmark
  34.      Europe
  35.  
  36.  
  37. How to use ANIFRA:
  38.  
  39. start ANIFRA from the command line (no option switches are used).
  40.  
  41.    Movement options works as follows:
  42.  
  43.    Zoom keeps same center and applies the zoom factor to each frame.
  44.    Zoom only applies on center-mag.
  45.    Circle generates points on a circle and uses center and radius.
  46.    Circle starts on the top.
  47.    Line uses a straight line between 2 points/parameters.
  48.    Point keeps same point/parameter in all frames.
  49.  
  50.    Enter center movement option (z/c/l/p):
  51.  
  52. Enter 1 character for the movement option. If an invalid option is used
  53. the program defaults to the point option.
  54.  
  55.    Center/starting point X,Y
  56.  
  57. Enter 2 numbers separated by a comma. If zoom or point is used the
  58. center coordinate is used in all frames. If line is used this is the
  59. starting point of the line. If circle is used this is the center of the
  60. circle.
  61.  
  62. If zoom is used the following will appear:
  63.  
  64.    Enter start magnification:
  65.    Enter zoom multiplication factor:
  66.  
  67. Start magnification is the magnification of the first frame. It is
  68. multiplied by the zoom factor between each frame. Use a multiplication
  69. factor > 1 to zoom closer, < 1 to zoom away, = 0 to bomb the program.
  70. If zoom is not used the magnification is set to 2/3.
  71.  
  72. If circle is used the following will appear:
  73.  
  74.    Enter radius for center-circle:
  75.  
  76. This is the radius of the circle used in the circular motion.
  77.  
  78. If line is used the following will appear:
  79.  
  80.    Enter center end point X,Y
  81.  
  82. Specify two numbers seperated by a comma. This is the end point for a
  83. linie type movement.
  84.  
  85.    Enter parameter movement option (c/l/p):
  86.  
  87. Enter 1 character for the movement option. If an invalid option is used
  88. the program defaults to the point option.
  89.  
  90.    Enter center/starting parameter point X,Y
  91.  
  92. Enter 2 numbers separated by a comma. If point is used the
  93. parameter is used in all frames. If line is used this is the starting
  94. point of the line. If circle is used this is the center of the circle.
  95.  
  96. If circle is used the following will appear:
  97.  
  98.    Enter radius for parameter circle:
  99.  
  100. This is the radius of the circle used in the circular motion.
  101.  
  102. If line is used the following will appear:
  103.  
  104.    Enter parameter end point X,Y
  105.  
  106. Specify two numbers seperated by a comma. This is the end point for a
  107. linie type movement.
  108.  
  109.    Enter number of steps:
  110.  
  111. This is the number of steps for the animation. The current max. is 1000
  112. steps. (should be enough unless you have a 486 and a gigabyte drive).
  113.  
  114.    Calculation options for the parameter file.
  115.    (see X menu in fractint for expected values)
  116.  
  117.    Passes=           (1/2/g/b)
  118.    Float=            (yes/no)
  119.    Type=             (fractal type)
  120.    Maxiter=          (maximum iteration count)
  121.    Bailout=          (bailout value)
  122.    Inside=           (see fractint as each new version has new options)
  123.    Outside=          (----------------------//------------------------)
  124.    Map=              (color map name without extension)
  125.  
  126. In this part the calulation options are specified. Most of these options
  127. is found in the X menu in fractint. If in doubt use the batch option in
  128. fractint and look in the resulting parameter file.
  129.  
  130.    Batch options. Will be included in the batch file.
  131.  
  132.    Enter name prefix for files and names (max. 5 char):
  133.  
  134. This prefix is the name of the batch and the parameter file. All
  135. parameter file entries and savenames will be prefixed with this name. If
  136. f.ex TEST is used the parameter file name will be TEST.PAR, batch file
  137. will be TEST.BAT and parameter entries and savenames will be TEST000---.
  138.  
  139.    Sound=            (on/off)
  140.    Video=            (see fractint for videomode names. F3 = 320 x 200
  141.    Gif87a=           (yes/no Use yes for use with ANIMATOR
  142.    Overwrite=        (yes/no Overwrite saved files with same name
  143.  
  144. ANIFRA then generates the files and exits. To trace your animation just
  145. type the name on the command line and wait. (this is a good time to raid
  146. the fridge).
  147.  
  148. Places to try:
  149.  
  150. Center point 0,0 parameter line from -2.5,0 to 1.5,0
  151. type=julia outside=0 inside=bof60 maxiter=25 passes=1
  152.  
  153. Center point 0,0 parameter circle around -1,0 radius 0.25 type=julia
  154. outside=0 inside=bof60 maxiter=25 passes=1
  155.  
  156. Hints and tips:
  157.  
  158. To pick a good spot for a julia animation look at the mandelbrot set.
  159. The closer to the edge of the set, the smaller the 'inside' of the julia
  160. will be and small variations have the biggest effect. This is the case
  161. with most escape-time fractals. Remember that Mandelbrot made the
  162. mandelbrot set as a catalog over julias. 
  163.  
  164. Bof61 inside coloring takes more frames to get smooth than bof60 inside 
  165. coloring. 
  166.  
  167. Bof61 often requires higher maxiter to use the whole palette 
  168. than bof60. (I use bof60 alot). 
  169.  
  170. Outside = 0 gives smaller GIF's (and saves space). 
  171.  
  172. On thin spindly structures solid guessing sometimes misses 
  173. fine lines. Use passes=1 to overcome this problem. 
  174.  
  175. On some images the pixels seem to big to 'big' for the structure of 
  176. the fractal. Some kind of anti-aliasing sometimes help. One way to do 
  177. this is to generate the GIF in higher resolutions and then use PICLAB 
  178. or another graphics toolkit to reduce the image to achive an 
  179. anti-aliasing effect. (just uses more space and takes more time).
  180.